home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3s / getws.z / getws
Encoding:
Text File  |  2002-10-03  |  4.2 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttwwwwssss((((3333SSSS))))                                                            ggggeeeettttwwwwssss((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _gggg_eeee_tttt_wwww_ssss_,,,, _ffff_gggg_eeee_tttt_wwww_ssss - get a _wwww_cccc_hhhh_aaaa_rrrr______tttt string from a stream
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_dddd_iiii_oooo_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_wwww_iiii_dddd_eeee_cccc_...._hhhh_>>>>
  14.      _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_gggg_eeee_tttt_wwww_ssss_((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_s_))))_;;;;
  15.      _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_ffff_gggg_eeee_tttt_wwww_ssss_((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_s_,,,, _iiii_nnnn_tttt _n_,,,, _FFFF_IIII_LLLL_EEEE _****_s_t_r_e_a_m_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN ((((IIIInnnntttteeeerrrrnnnnaaaattttiiiioooonnnnaaaallll FFFFuuuunnnnccccttttiiiioooonnnnssss))))
  18.      _gggg_eeee_tttt_wwww_ssss reads EUC characters from _ssss_tttt_dddd_iiii_nnnn, converts them to _wwww_cccc_hhhh_aaaa_rrrr______tttt
  19.      characters, and places them in the _wwww_cccc_hhhh_aaaa_rrrr______tttt array pointed to by _s.  _gggg_eeee_tttt_wwww_ssss
  20.      reads until a newline character is read or an end-of-file condition is
  21.      encountered.  The newline character is discarded and the _wwww_cccc_hhhh_aaaa_rrrr______tttt string
  22.      is terminated with a _wwww_cccc_hhhh_aaaa_rrrr______tttt null character.
  23.  
  24.      _ffff_gggg_eeee_tttt_wwww_ssss reads EUC characters from the stream, converts them to _wwww_cccc_hhhh_aaaa_rrrr______tttt
  25.      characters, and places them in the _wwww_cccc_hhhh_aaaa_rrrr______tttt array pointed to by _s.  _ffff_gggg_eeee_tttt_wwww_ssss
  26.      reads until _n-_1111 _wwww_cccc_hhhh_aaaa_rrrr______tttt characters are transferred to _s, or a newline
  27.      character or an end-of-file condition is encountered.  The _wwww_cccc_hhhh_aaaa_rrrr______tttt string
  28.      is then terminated with a _wwww_cccc_hhhh_aaaa_rrrr______tttt null character.
  29.  
  30. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  31.      _ffff_eeee_rrrr_rrrr_oooo_rrrr(3S), _ffff_oooo_pppp_eeee_nnnn(3S), _ffff_rrrr_eeee_aaaa_dddd(3S), _ssss_cccc_aaaa_nnnn_ffff(3S), _ssss_tttt_dddd_iiii_oooo(3S), _gggg_eeee_tttt_wwww_cccc(3S),
  32.      _wwww_iiii_dddd_eeee_cccc(3S).
  33.  
  34. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  35.      If end-of-file or a read error is encountered and no characters have been
  36.      transformed, no _wwww_cccc_hhhh_aaaa_rrrr______tttt characters are transferred to _s and a null
  37.      pointer is returned and the error indicator for the stream is set.  If
  38.      the read error is an illegal byte sequence, _eeee_rrrr_rrrr_nnnn_oooo is set to _EEEE_IIII_LLLL_SSSS_EEEE_QQQQ.  If
  39.      end-of-file is encountered, the _EEEE_OOOO_FFFF indicator for the stream is set.
  40.      Otherwise, _s is returned.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.